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NAME 

console — bitmap display and keyboard 

DESCRIPTION 

PARTIAL ANSI EMULATOR 

The console of the LISA running UniPlus+ is the built-in bitmap display 
and keyboard. To be used as the console terminal it has some features of a 
Digital VTIOO terminal and includes certain additional features. The 
termcap entry is vtl. The size of the screen is 38 lines by 90 columns. The 
following sequences apply: 

<esc>]\1 reverse scroll 

<esc>H set horizontal tab stop at cursor position 

The optional parameter <nl> in the following is a numeric value given by 
a string of zero or more decimal characters in ASCII representation. A 
value of one (1) is assumed for missing or zero- value arguments. 



<esc> |<nl> A 


move cursor up <nl> rows, or to the top 
if <nl> is > current row 


<esc> 1 


Knl>B 


move cursor down <nl> rows, or to the 
bottom if current row + <nl> is > max- 






imum row 


<esc> 1 


l<nl>C 


move cursor right <nl> columns, or to 
the right margin if current column + 
<nl> is > maximum column 


<esc> i 


l<nl>D 


move cursor left <nl> columns, or to the 
left margin if <nl> is < current column 


<esc> 1 


l<nl >L 


insert < nl > line(s) 


<esc> 1 


Knl>M 


delete < nl > line(s) 


<esc> 1 


l<nl>P 


delete <nl> character(s) 



The optional parameter <nl> in the following is a numeric value given by 
a string of zero or more decimal characters in ASCII representation. A 
value of zero (0) is assumed for missing arguments. 



<esc> I< nl > J 



<esc>l<nl>K 



<esc> l<nl >g 



clear screen 

if <nl> is 0, clear from cursor to end of 
display 

if <nl> is 1, clear from beginning of 
display to cursor 

if <nl> is 2, clear entire screen 
clear line 

if <nl> is 0, clear from cursor to end of 
line 

if <nl> is U clear from beginning of line 
to cursor 

if <nl> is 2, clear entire line 
clear tab stops 
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if <nl> is 0, clear tab stop at the cursor 
position 

if <nl> is 3, clear all tab stops 

<esc> I<nl>m set/ reset reverse video or underlining all 

characters written to the screen after this 
are written according to the new settings 
if <nl> is 0, set normal video and no 
underlining 

if <nl> is 1, set reverse video 
if <nl> is 4, set underlining 
if <nl> is 7, set reverse video 
Note that more than one attribute can be 
specified at a time; 

<esc> [<nl >;<n2>m is identical to 
<esc>[<nl>m<esc>[<n2>m. A max- 
imum of 10 such numeric parameters is 
allowed. 

The optional parameter(s) <nl>, <n2> are numeric values given by a 
string of zero or more decimal characters in ASCII representation. A value 
of zero (0) is assumed for missing arguments. A value of zero (0) is 
assumed for the second argument if the semicolon (;) is missing. 

<esc> I<nl > ;<n2>H move cursor to row <nl>, column <n2> 

or the appropriate edge of the screen if 
<nl> or <n2> is out of bounds. Row 
and column values are 0 origin (i.e., 0 < = 
value < maximum) 

<esc> l<nl >;<n2>f move cursor to row <nl>, column <n2> 

or the appropriate edge of the screen if 
<nl> or <n2> is out of bounds. Row 
and column values are 0 origin (i.e., 0 < = 
value < maximum) 



KEYBOARD 

Some keys on the Lisa console keyboard require explanation. 



This table 



vs how UNIX uses these 


keys. 


Key 


Use in UNIX 


command 


control 


clear 


delete 


left option 


escape 


right option 


escape 


enter 


line feed 


4 — 


move cursor one character left 




move cursor one character right 


t 


move cursor one character up 


1 


move cursor one character down 
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The eighteen keypad keys require further explanation. The key labelled 
clear is always the delete key. The arrow keys always cause cursor motion 
in the appropriate direction, by transmitting the correct escape sequence. 
Normally a shifted arrow key causes the corresponding character (+ * / or 
,) to be transmitted. The enter key causes a newline to be transmitted. 
The remaining twelve (12) keys correspond to these characters (1 2 3 4 5 6 
7 8 9 0 - and .). 

<esc> = enter alternate keypad mode 

<esc> > exit alternate keypad mode 



In alternate keypad mode the seventeen (17) keypad keys (all except the 
clear key which is used for delete) cause a special code to be transmitted, 
according to the following table: 



0 

1 

2 

3 

4 

5 

6 

7 

8 
9 



enter 

+ 

* 



/ 



<esc>Op 

<esc>Oq 

<esc>Or 

<esc>Os 

<esc>Ot 

<esc>Ou 

<esc>Ov 

<esc>Ow 

<esc>Ox 

<esc>Oy 

<esc>Om 

<esc>01 (shifted down arrow) 

<esc>OM 

<esc>OP (shifted left arrow, function key 

1 ) 

<esc>OQ (shifted right arrow, function key 

2 ) 

<esc>OR (shifted up arrow, function key 3) 



If the codes are echoed back to the screen the last character of the 
sequence will be displayed. 



I/O CONTROLS 

The console driver for the LISA provides the following I/O controls to 
allow the user to modify parameters on the system. The following values 
are defined in /usr/include/sys/al_ioctI.h: 



To set parameter values: 
ioctl (fp, AL SBVOL, value) 
iocti (fp, AL SBPITCH, value) 
ioctl (fp, AL SBTIME, value) 

ioctl (fp, AL SDIMTIME, value) 



set bell volume (0-7) 
set bell pitch (0-8191) 

set bell time (in clock tics, limited to 
10 seconds) 

set time before dimming screen (in 
clock tics) 



- 3 - 






Ocfoher !<)H4 




CONSOLE (5L) 



CONSOLE (5L) 



ioctl (fp, AL SDIMCONT, value) 
ioctl (fp, AL_SDIMRATE, value) 
ioctl (fp, AL SCONTRAST, value) 

ioctl (fp, AL_SREPWAIT, value) 

ioctl (fp, AL SREPDELAY, value) 

To get parameter values: 
ioctl (fp, AL GBVOL, value) 
ioctl (fp, AL_GBPITCH, value) 
ioctl (fp, AL GBTIME, value) 
ioctl (fp, AL GDIMTIME, value) 
ioctl (fp, AL GDIMCONT, value) 
ioctl (fp, AL GDIMRATE, value) 
ioctl (fp, AL_GCONTRAST, value) 
ioctl (fp, AL_GREPWAIT, value) 
ioctl (fp, AL GREPDELAY, value) 

Other parameters: 

ioctl (fp, AL_REVVIDEO, f) 



ioctl (fp, AL_GBMADDR, &addr) 



set screen contrast when dim (0-255) 

set rate of dimming (in clock tics) 

set screen contrast when bright (0- 
255) 

set wait before repeating keys (in 
clock tics) 

set delay between key repeat (in 
clock tics) 

get bell volume 
gel bell pitch 
get bell time 

get time before dimming screen 
get screen contrast when dim 
get rate of dimming 
get screen contrast when bright 
get wait before repeating keys 
get delay between key repeat 

control the display mode 

if f is greater than zero, screen back- 
ground is set to bright 
if f is zero, screen background is 
black 

if f is negative, screen background is 
complemented 

get physical address of beginning of 
bitmap display 
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NAME 

c, rc — Corvus hard disk interface 

DESCRIPTION 

This section describes the special files corresponding to the parallel-port 
Corvus disk drives. 

The LISA has one built-in parallel port and up to six expansion ports. Any 
combination of the six expansion ports and the built-in port may be dedi- 
cated to Corvus disks. 

A hard disk is accessed through a block special or character special file. See 
mknodilM) for a description of how to create such a file. The major device 
number is 2 for block interface or 11 for character (raw) interface. The 
minor device number specifies the physical unit number and the logical par- 
tition through which the disk will be accessed. This number is calculated 
by: 



(16 * physical unit number) + (logical partition number) 



Valid physical unit numbers are 0, 1,2, 4, 5, 7 and 8. (Units 3 and 6 are 
skipped for historical reasons.) 



Unit 


Unit*16 


Position 


0 


0 


"Built-in” port 


1 


16 


Slot 1 Bottom Port 


2 


32 


Slot 1 Top Port 


4 


64 


Slot 2 Bottom Port 


5 


80 


Slot 2 Top Port 


7 


112 


Slot 3 Bottom Port 


8 


128 


Slot 3 Top Port 



Logical partitions indicate, by block offset and size, which 512-byte blocks 
of the disk are to be accessed. The following table shows the available logi- 
cal partitions: 



Partition 


Name 


Block Offset 


Size 


Intended Use 


0 


a 


4060 


32420 


root filesystem 


1 


b 


101 


3959 


swap area 


2-6 


c-g 


n/a 


n/a 


unused 


7 h 

UNIX does not allow access to 


101 

the first 101 


36379 

blocks. 


entire disk 



The conventional names for the special files are: 

• first character of a block device is c (corvus), 

• first two characters of a character device are rc (raw corvus), 

• next a digit, the physical unit number (0,1, 2, 4,5, 7, 8), and 

• last a character, the logical partition (a,b,h) 
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NAME 

eject — eject the Sony microdiskette 

SYNOPSIS 

eject [ device ] 

DESCRIPTION 

Eject is used to eject the Sony microdiskette. If the Sony is not in use, it 
will be ejected from its drive. If it is open for any reason, the eject will fail. 

A character-special device must be specified. If the major device number is 
6, then the standard character interface for the Sony disk is used. A major 
device number of 7 is used for a special character interface for the Sony 
disk which allows only the eject function. Either device can be specified. If 
none is given explicitly, then /dev/rsOa is used. It is assumed that 
/dev/rsOa is set up with major device number 6 and minor device number 
0 . 



FILES 

/dev/rsOa default character-special device 

/dev/eject character-special file only used for ejecting 
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NAME 

mouse — general mouse interface 

DESCRIPTION 

This section describes the special file corresponding to the mouse. 

The file /dev/mouse is the only interface to the data generated by the 
mouse. A request to open the mouse will fail under any of the following 
circumstances: 

The mouse is not plugged in. (ENODEV) 

The mouse is already open. (EBUSY) 

The requesting process does not have the console as its controlling ter- 
minal. (eperm) 

The open mode includes writing. (EINVAL) 

The minor device number is not zero. (ENXIO) 

Mouse data is generated and added to the input queue in records. The 
record format (as defined in the include file sys/mouse.h) is as follows: 

struct msrecord ( 



ushort 


mrreset:! ; 


/* driver reset */ 


ushort 


mr_but:l; 


/* button down */ 


ushort 


mr_ctl:l; 


I* Ctrl key down */ 


ushort 


mr_sft:l; 


h shift key down */ 


ushort 


mr_time:12; 


/* time generated */ 


char 


mr_row; 


}* row offset */ 


char 


mrcol; 


h column offset */ 



If the mrjeset bit is set, then the mouse driver was recently reset. The 
mr_but bit indicates the reason for the reset. A 0 means that a new mouse 
was plugged in. A 1 means that the flush time elapsed and all the mouse 
records were discarded. None of the other fields are valid for reset records. 

The mr_but bit reflects the state of the mouse button (1 means pressed 
down, 0 means released.) 

The mr^ctl bit reflects the state of the keyboard command (APPLE) key. 

The mr_sft bit is 1 if either or both shift keys are down, 0 if both are up. 

The mrjime field contains the low order 12 bits of the clock ticks counter 
at the time this mouse record was generated. It is useful for determining 
the elapsed time between different mouse events. 

The mr row field contains the vertical offset in hundredths of an inch. 
Negative means away from the user, positive means towards the user 
(down the screen). The range is -128 to +127. 

The mr_col field contains the horizontal offset in hundredths of an inch. 
Negative means to the left; positive means to the right. The range is -128 
to +127. 

When the mouse is moving, records are generated at the programmed 
interrupt rate (initially 28 milliseconds). In addition, records are generated 
whenever the mouse button is pressed down or released, and when the 
mouse device is plugged in or unplugged. Depending on certain control 
parameters, mouse records may be generated for either or both keyboard 
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APPLE and SHIFT keys or for synchronization with the screen refresh rate. 
Read requests for the mouse device will fail if any of the following are true: 
The mouse has been unplugged. (ENODEV) 

The buffer address is odd or the input byte count is not a multiple of 
the record size; sizeof (struct msrecord). (EINVAL) 

The mouse has been disabled by an ioctl request (see below). (ElO) 

Two /oc//(2) system calls apply to the mouse device. AL GMOUSE fills the 
following structure in user space with the appropriate data from the mouse 
driver. AL SMOUSE “programs” the mouse driver according to the struc- 
ture in user space. The structure is also defined in the include file 
sys/mouse.h; 

struct msparms i 



ushort 


mpfdlay; 


/* flush delay */ 


ushort 


mp_irate; 


/* interrupt rate */ 


ushort 


mp_qlen; 


/* records available */ 


ushort 


mpflags; 


/* control flags */ 


ushort 


mp_otime; 


/* oldest records age ♦/ 


ushort 


mp_ytime; 


/* youngest records age */ 



The mp J'dlay field is the number of clock ticks (60ths of a second) before 
all the mouse data is flushed if not read. If set to zero, then mouse data is 
never flushed automatically. If set to a value less than 20 ticks the mouse 
driver buffer is flushed but the flush delay remains unaffected and no reset 
record is generated. The value of mpj'dlay is set to 300 (5 seconds) when 
the mouse is opened. The maximum value for this field is 4095 and indi- 
cates a time of about 68 seconds. 

The mpjrate field is the rate at which mouse records are generated when 
the mouse is moving. If zero then the mouse is disabled and no new 
records will be added to the queue until the interrupt rate is reset. This 
field is reset to 28 every time the mouse is opened. The range of values is 
0 to 28 in increments of 4 milliseconds. 

The mp_qlen field is the number of records currently available. The 
driver’s internal buffer can hold up to 128 mouse records. When there are 
already 128 records available, new mouse information is thrown away. 

The mp_Jfags field is composed of the following flags (when the mouse is 
open, the MF BUT bit is set to one and the rest are set to zero): 



MF_VRATE 00000007 

MF_BLK 00000010 

MF_SIG 00000020 

MF_BUT 00000040 

MF_CTL 00000100 

MF_SFT 00000200 

MF_VRT 00000400 



Vertical Retrace Interrupt rate. 

Block until data is available. 

Signal (SIGMOUS) when data becomes available. 
Enable/Disable mouse button events. 

Enable/ Disable command key events. 
Enable/Disable shift key events. 

Enable/Disable vertical retrace interrupts. 



If MF_BLK is not set, then reads return EOF when no mouse data is 
present. If set, then the requesting process is suspended until at least one 
mouse record becomes available. If MF VRT is also set, then EOF will be 
returned after the next vertical retrace interrupt. 
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If MF SIG is set, then a signal (SIGMOUS) is sent to the process group of 
the console when the first record is generated. 

The MF BUT flag enables/disables the generation of mouse records from 
mouse button events. When this bit is set, pressing the mouse button will 
generate two events: one when the button goes down and one when it 
comes up. Turning off this bit means that events will not be generated for 
activity by the mouse button but its state will continue to be reported in 
mouse records. 

The MF CTL flag enables/disables the generation of mouse records from 
the command key on the keyboard. This key is considered the second 
mouse button. Its semantics are similar to that of MF BUT. 

The MF SFT flag enables/disables the generation of mouse records from 
either of the SHIFT keys on the keyboard. Either SHIFT key is considered 
the third mouse button. The semantics are similar to that of MF BUT. 

The MF VRT flag enables/disables the generation of SIGMOUS interrupts 
each time the hardware has finished repainting the screen. Synchronizing 
screen updates with this signal will reduce screen flicker because the pro- 
gram and hardware will not be working on the same area of memory at the 
same time. It is set by an AL GMOUSE call. If no records are available, 
this field is set to 0. 

The mp_otime field contains the age in clock ticks of the oldest available 
mouse record (i.e., the next one to be read). The vertical retrace interrupt 
rate can be used to slow down the generation of SIGMOUS interrupts due to 
MF VRT. It has no meaning if MF VRT is not set. MF VRATE is a number 
between 0 and 7 which specifies how many vertical retrace interrupts will be 
skipped between those which cause SIGMOUS interrupts. 

The mp ytime field contains the age in clock ticks of the youngest available 
mouse record (i.e., the most recently generated). It is set by an 
AL GMOUSE call. If no records are available, this field is set to 0. 
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NAME 

pm, rpm — Priam dalatower disk drive 

DESCRIPTION 

This section describes the special files corresponding to the Priam disk 
drives. 

The LISA has three expansion slots, any combination of which may be 
dedicated to Priam devices. 

A hard disk is accessed through a block special or character special file. See 
mknodiUA) for a description of how to create such a file. The major device 
number is 3 for block interface or 12 for character (raw) interface. The 
minor device number specifies the physical unit number and logical parti- 
tion through which the disk will be accessed. It is calculated by: 

(16 * physical unit number) + (logical partition number) 

Valid physical unit numbers are 0, 1, and 2. 

Unit Unit*16 Position 

0 0 Slot 1 

1 16 Slot 2 

2 32 Slot 3 

Logical partitions indicate, by block offset and size, which 512-byte blocks 
of the disk are to be accessed. The following table shows the available logi- 
cal partitions: 



Partition 


Name 


Block Offset 


Size 


Intended Use 


0 


a 


4101 


to end of disk 


root filesystem 


1 


b 


101 


4000 


swap area 


2-6 


c-g 


n/a 


n/a 


unused 


7 


h 


101 


to end of disk 


entire disk 



UNIX does not allow access to the first 101 blocks. 

Drives of different sizes are available for the Priam Datatower. They are 
currently available with 35 MB, 70 MB, and 86 MB (unformatted). When 
the disk is first opened, UNIX determines its size and adjusts the sizes of 
partitions 0 and 7 accordingly. An I/O control, UlOCSIZE, is available to 
get the size of a disk (see ioctlil)). This call will get the number of blocks 
on the disk: 

#include "sys/uioctl.h" 
int fp, pmsize; 

ioctUfp, UlOCSIZE, 

(caddrO&pmsize); 

The size of partition 0 is (pmsize - 4101) blocks, and the size of partition 7 
is (pmsize - 101) blocks. 

As with any other hardware, UNIX does not expect a Priam disk to be 
replaced while UNIX is running. A disk should not be turned off or 
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changed without first rebooting the system. 

The conventional names for the special files are: 

• first two characters of a block device are pm (priam), 

• first three characters of a character device are rpm (raw priam), 

• next a digit, the physical unit number (0,1,2), and 

• last a character, the logical partition (a,b,h) 
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NAME 

p, rp — profile hard disk interface 

DESCRIPTION 

This section describes the special files corresponding to the parallel-port 
profile disk drives. 

The LISA has one built-in parallel port and up to six expansion ports. The 
built-in port has a 10MB hard disk which is accessed through the profile 
interface. Any combination of the six expansion ports may also be dedi- 
cated to profile devices. 

A hard disk is accessed through a block special or character special file. See 
mknod{\M) for a description of how to create such a file. The major device 
number is 0 for block interface or 5 for character (raw) interface. The 
minor device number specifies the physical unit number and the logical par- 
tition through which the disk will be accessed. This number is calculated 
by: 



(16 * physical unit number) + (logical partition number) 



Valid physical unit numbers are 0, 1,2, 4, 5, 7 and 8. (Units 3 and 6 are 
skipped for historical reasons.) 



Unit Unit*16 


Position 


0 


0 


Built-in disk 


1 


16 


Slot 1 Bottom Port 


2 


32 


Slot 1 Top Port 


4 


64 


Slot 2 Bottom Port 


5 


80 


Slot 2 Top Port 


7 


112 


Slot 3 Bottom Port 


8 


128 


Slot 3 Top Port 


Logical partitions 


indicate, 


by block offset and size, which 512-byte blocks 


of the disk are to 


be accessed. The following table shows the available logi- 



cal partitions; 



Partition 


Name 


Block Offset 


Size 


Intended Use 


0 


a 


2501 


16955 


root filesystem 


1 


b 


101 


2400 


swap area 


2 


c 


2501 


7227 


root filesystem 
(on 5MB 

disk) 


3 


d 


9728 


9728 


extra partition 
(use with 2) 


4,5,6 


e,f,g 


n/a 


n/a 


unused 


7 


h 


101 


19355 


entire disk 



UNIX does not allow access to the first 101 blocks. 

Partitions are used to divide disks into filesystems and swap space. The 
conventional names for the special files are: 
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• 

EXAMPLE 

/dev/pOa 

/dev/pOb 

/dev/plh 

/dev/pOc 

/dev/pOd 

/dev/pOb 

/dev/p4b 

/dev/p4c 
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first character of a block device is p (profile), 
first two characters of a character device are rp (raw profile), 
next a digit, the physical unit number (0,1, 2,4, 5, 7, 8), and 
last a character, the logical partition (a,b,c,d,h) 

root filesystem on the built-in disk 
swap space on the built-in disk 

a large filesystem using all of the disk in the bottom port of 
slot 1 

small root filesystem on the built-in disk 
9728-block filesystem on the built-in disk 
small 2400-block filesystem on the built-in disk 
swap space on the disk in the bottom port of slot 2 
7227-block filesystem on the disk in the bottom port of slot 2 
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NAME 

rtc — real time clock 

DESCRIPTION 

This section describes the special file corresponding to the real time clock. 
The program setrtc is available for reading and setting the real time clock. 
Each time UNIX is booted, the real time clock is read to set the system 
time. 

The real time clock is accessed through a character special file /dev/rtc. 
See mknoct{\M) for a description of how to create such a file, /dev/rtc has 
major device 13 and minor device 0. UNIX records time values in seconds 
since 00:00:00 GMT, January 1, 1970. A read of four bytes from the real 
time clock returns a long integer with its current setting. A write of four 
bytes resets the clock. Only reads or writes of four bytes are allowed. 

EXAMPLES 

The following C program segments describe how to access the real time 
clock. 



long rt; 

if ((fp = open(Vdev/rtc", oflag)) < 0) 

(void) fprintf(stderr, "setrtc: cannot open /dev/rtc"); 

if (read(fp, (char *)&rt, sizeof(rt)) < 0) 

(void) fprintf(stderr, "setrtc: cannot read /dev/rtc"); 

if (write(fp, (char *)&rt, sizeof(rt)) < 0) 

(void) fprintf(stderr, "setrtc; cannot write /dev/rtc"); 
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NAME 

setparams ~ tune changeable parameters for console screen, console key- 
board, and bell 

SYNOPSIS 

setparams 

DESCRIPTION 

The parameters you can adjust are: 



bvol 

bpitch 

btime 

dimtime 

dimcont 

dimrate 

contrast 

repwait 

repdelay 

revvideo 



bell volume 
bell pitch 
bell duration 

time before screen saver dimming 

screen contrast when screen is dim 

rate at which screen goes from bright to dim 

screen contrast when screen is bright 

how long key must be held before it starts repeating 

delay between key repetitions 

select/cancel/switch reverse video 



To set any of these, type the appropriate name to the question 
What is your selection? 

For example, type bvol to set the volume of the bell. 

Changing the background color is handled differently from the other 
choices (see below). For the other parameters the current setting is 
displayed. If a carriage return alone is typed, the setting remains the same. 
Otherwise, it is changed to what is entered. The parameter values are 
retrieved and set using the /oc7/ calls documented in consoleiS). For exam- 
ple, the bell volume is retrieved using AL GBVOL and set using AL SBVOL. 
See consoleiS) for details such as the range of values which can be used for 
each of the parameters. 

Changing the background color is done using “revvideo.” No current set- 
ting is displayed since this should be obvious. The background color can be 
either black or white. A black background is referred to as “normal” and a 
white background as “reverse video.” If a carriage return alone is typed 
the setting remains the same. Otherwise: 

+ the screen becomes black characters on a white background, 

0 the screen becomes white characters on a black background, or 
the screen becomes the reverse image of its current state. 



The background color is set using the ioctl call AL REVVIDEO documented 
in consoleiS). 

To run setparams you must be able to open /dev/console for reading and 
writing. Normally this means you must be logged in as root or logged in at 
the console (the bitmap display on the LISA). 

Use CONTROL-D to exit setparams. 
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SEE ALSO 

console(5) 
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NAME 

seme — read the real time clock, and optionally set it and/or the UNIX sys- 
tem time 

SYNOPSIS 

setrtc [-si [mmddhhmm[yy]] 

DESCRIPTION 

Reads and prints the current time from the real time clock. If the date 
argument is given, the clock is set first. If the — s flag is used, the system 
date is set to the time read from the real time clock. 

The date is specified exactly as for the date utility. 



The first mm is the month number; 

dd is the day of the month; 

hh is the hour (24 hour system); 

the second mm is the minute; 

yy is the last two digits of the year and is optional. 

The current year is the default if no year is mentioned. Setrtc converts to 
and from local standard and daylight time. 

The real time clock is always accessed through the special file /dev/rtc. 
The permissions for this file determine which users may read or set it. 



EXAMPLES 



setrtc 
setrtc -s 

setrtc 10081700 
setrtc 10081700 -s 



prints real time clock value 

prints real time clock value and sets system 

time to the same value 

sets real time clock to October 8, 5:00 pm, 

then reads the real time clock and prints its 

value 

sets real time clock to October 8, 5:00 pm, 
then reads the real time clock, prints its 
value, and sets the system time to the same 
value 



DIAGNOSTICS 

bad conversion 

The syntax of the date argument is incorrect. 

cannot open/read/write /dev/rtc 

No permission to access the real time clock for the indicated 
function— tries to open /dev/rtc for writing only if an attempt 
is made to set the real time clock. 

no permission for setting system time 

Only the super-user is allowed to set the system time. 



FILES 

/dev/rtc 

WARNING 

It is a bad practice to change the date while the system is running multi- 
user. 
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NAME 

SIO card — Tecmar Quad serial I/O card 

DESCRIPTION 

This section describes the special files corresponding to the Tecmar four- 
port card. 

The LISA has three expansion slots, any combination of which may hold a 
Tecmar serial card. 

Each serial port is accessed through a character special file. See 
mknodiXM) for a description of how to create such a file. The major device 
number is 14 for this card. The minor device number specifies the location 
of the port and whether modem control handling is enabled. 

There is dynamic system configuration on system boot and the positioning 
of multiple Tecmar boards in the LISA card cage is important. The first 
Tecmar board (left to right looking towards the back of the LISA) has port 
numbers 0 through 3. The Tecmar board to its right has ports 4 through 7. 
A third Tecmar board has ports 8 through 1 1. 

Port Position 

0 first card, bottom RS-232 slot connected to card cage 

1 first card, top RS-232 slot connected to card cage 

2 first card, bottom RS-232 slot connected to ribbon cable 

3 first card, top RS-232 slot connected to ribbon cable 

4 second card, bottom RS-232 slot connected to card cage 

5 second card, top RS-232 slot connected to card cage 

6 second card, bottom RS-232 slot connected to ribbon cable 

7 second card, top RS-232 slot connected to ribbon cable 

8 third card, bottom RS-232 slot connected to card cage 

9 third card, top RS-232 slot connected to card cage 

10 third card, bottom RS-232 slot connected to ribbon cable 

1 1 third card, top RS-232 slot connected to ribbon cable 

If no modem control is desired then the standard minor devices, 0 through 
11, should be used. A modem control line is indicated by adding 128 to 
the port number. If modem control on some line(s) is desired then that 
line(s) should have a minor device number greater than 127, while other 
line(s) on that card can have standard device numbers. For example, if 
only the last two ports on the first card need modem control, then the 
minor devices should be 0, 1, 130, and 131. 
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NAME 

s, rs — Sony disk interface 

DESCRIPTION 

This section describes the special files corresponding to the Sony micro- 
diskette. 

A Sony microdiskette is accessed through a block special or character spe- 
cial file. See mknod{\M) for a description of how to create such a file. The 
major device number is 1 for block interface, or 6 for character (raw) inter- 
face. The minor device number specifies the logical partition through 
which the disk will be accessed. 

Logical partitions indicate, by block offset and size, which 512-byte blocks 
of the disk are to be accessed. The following table shows the available logi- 
cal partitions: 



Partition 


Name 


Block Offset 


Size 


Intended Lise 


0 


a 


0 


800 


root filesystem 


1 


b 


201 


599 


filesystem on 
boot diskette 


2 


c 


0 


201 


remainder of 
boot diskette 


3-6 


d-g 


n/a 


n/a 


unused 


7 


h 


0 


800 


entire disk 



UNIX does not allow access to the first 201 blocks of a boot or serialization 
diskette. 

The conventional names for the special files are: 

• first character of a block device is s (sony), 

• first two characters of a character device are rs (raw sony), 

• next the digit 0, the physical unit number, and 

• last a character, the logical partition (a,b,c,h) 

A limited character interface is also available. Character major device 7 
allows only the eject function, /dev/eject can be specified as the argument 
to the eject utility. 



Oaober 1^4 



- 1 - 




SPEAKER (5L) 



SPEAKER (5L) 



NAME 

speaker — interface to the LISA speaker 

DESCRIPTION 

This section describes the special file corresponding to the built in speaker. 

The file /dev/speaker is the general purpose interface to the LISA speaker. 
This device is capable of producing square wave output at one of 8 volumes 
between 125,000 to 122 cycles per second. A request to open the speaker 
will fail under any of the following circumstances: 

The speaker is already open. (EBUSY) 

The open mode does not include writing. (EINVAL) 

The minor device number is not zero. (ENXIO) 

Speaker data is written in records. The record format (as defined in the 
include file sys/speaker.h) is as follows: 

struct speaker ( 

ushort sk_wavlen; h wave length */ 
ushort sk_duration; /* duration ♦/ 
ushort sk volume; /* volume */ 

}; 

The sk_\vavlen is a measure in microseconds between transitions of the 
waveform. Values less than 8 are rounded up to 8 and represent the shor- 
test wavelength (about 125,000 cycles per second) which is well above the 
audible range. The maximum value is 8191 and corresponds to about 122 
cycles per second. 

The sk duration field is the number of clock ticks to maintain the sound. A 
clock tick on the LISA is l/60th of a second. 

The sk_voIume field determines the volume. Only the low 3 bits are used. 



October 1984 



- 1 - 




